home *** CD-ROM | disk | FTP | other *** search
/ Practical Algorithms for Image Analysis / Practical Algorithms for Image Analysis.iso / README.TXT < prev    next >
Text File  |  1999-09-11  |  9KB  |  182 lines
  1.                   Practical Algorithms for Image Analysis
  2.  
  3.                        Description, Examples and Code
  4.  
  5.  
  6.  Michael Seul                                            Michael J. Sammon
  7.  BioArray Solutions, LLC    Lawrence O'Gorman          Lucent Technologies
  8.                              Veridicom, Inc.
  9.                                                        Liberty Corner, New
  10.  Piscataway, New Jersey     Chatham, New Jersey                     Jersey
  11.  
  12.  
  13.  
  14. General Information
  15.  
  16. The code examples found on this CD-ROM are in sub directories whose name
  17. corresponds to chapter sections in the text.  For example, the programs in
  18. chapter 2, section 1 are in the directory ch_2.1.  The executables as well
  19. as the source for all programs are included.  Additional library routines
  20. are found under the libtiff, libimage and libip directories.
  21.  
  22. All source code files (*.c and *.h) are stored in UNIX format (i.e. they do
  23. not have the CR-LF line terminator that DOS text editors expect).  Windows
  24. programs such as WordPad and the Visual C++ editor will not have trouble
  25. displaying these files properly.  However Notepad will not be able to
  26. display the source files and is not recommended for editing.  A LINUX
  27. utility program is included to convert between UNIX and DOS text formats.
  28. This program is in the util/linux/tofrodos-1.1 directory.
  29.  
  30. Development environments for both LINUX and Microsoft Windows are
  31. supplied.  For compatibility across operating systems, all programs are
  32. compiled as console applications and are invoked from a command line
  33. prompt.
  34.  
  35. Because of licensing requirements, the libtiff image library is compiled
  36. without Lempel-Ziv-Welch (LZW) compression.  Therefore, those programs that
  37. use image files for input and output support only uncompressed TIFF at
  38. present.  It is up to the user to acquire graphics conversion utilities for
  39. converting images to uncompressed TIFF.  Alternatively, the user can
  40. download the full version of libtiff from ftp://ftp.sgi.com/graphics/tiff
  41. that includes compression and recompile all programs.
  42.  
  43. Compression for binary images (G3/G4 fax compression) is currently disabled
  44. because of inconsistencies in the way image editors display these types of
  45. files.  Some programs (Adobe Photoshop for Windows and xv for LINUX in
  46. particular) display G3/G4 compressed binary TIFF images properly.  There
  47. are other programs that display these files by inverting the bitmap.  To
  48. enable G3/G4 compression for binary images, see the ImageOut() routine in
  49. tiffimage.c under the libimage directory.
  50.  
  51. Hardware Requirements
  52.  
  53. A Pentium class machine, 100MHz or greater with at least 32Mb of RAM is
  54. suggested to run these programs in either a Win32 or LINUX environment.
  55. Installing the executables requires at least 50 Mb of free disk space.
  56. Installing the entire distribution requires at least 300 Mb of free disk
  57. space.  A graphics adapter set to a mode of displaying at least 256 colors
  58. is required for viewing the sample image files.
  59.  
  60. Windows95, Windows98, WindowsNT Installation and Requirements
  61.  
  62. The windows executables of the programs on this CD-ROM have been compiled
  63. using Microsoft Visual C++ Version 4.0.  Although the programs have been
  64. compiled and run on both Windows95 and Windows98, the authors are confident
  65. that they should run equally well under WindowsNT.  All development
  66. environment files are included as well as the Debug and Release sub
  67. directories.
  68.  
  69. To install only the executables, select the bindosd directory (debug
  70. version) or bindosr directory (release version) and drag the directory to
  71. the desired target hard drive and subdirectory using Windows Explorer.
  72.  
  73. To install all the development environments on your computer, select all
  74. the ch_* directories along with the libtiff, libimage and libip directories
  75. and drag these directories to the desired hard drive and subdirectory using
  76. Windows Explorer.  NOTE: as part of the build process under Microsoft
  77. Visual C++, we have included a custom build step that will copy the
  78. executable after a successful compile to either the bindosr or bindosd
  79. directory depending on whether Release or Debug is selected.  Therefore,
  80. the bindosr and bindosd directories must exist at the same level as the
  81. ch_* directories.
  82.  
  83. Alternatively, using Windows Explorer, you can select "Copy" under "Edit"
  84. after the directories have been selected and then select the target drive
  85. and directory, and select "Paste" under "Edit" to copy directories.
  86.  
  87.  
  88. LINUX Installation and Requirements
  89.  
  90. NOTE: To enable filenames longer that the ISO9660 8.3 naming convention,
  91. the CD-ROM has been formatted using the Microsoft Joliet filesystem.  Some
  92. LINUX systems may not be able to read this format without patching the
  93. kernel.  In this case unzip the file tarfile.gz using the gunzip LINUX
  94. utility.  The result will be a file named tarfile from which the entire
  95. distribution can be extracted using the following command:
  96. tar -xvf tarfile
  97.  
  98. The LINUX executables of the programs on this CD-ROM have been compiled
  99. using gcc version 2.7.2 under the LINUX kernel version 2.0.0 with Red Hat
  100. version 3.0.3.
  101.  
  102. To install the executables only, copy everything under the binlin directory
  103. to the desired target directory.  For example:
  104. cp /cdrom/binlin/* /usr/home/<userid>/bin
  105. would copy all the LINUX executables to the bin directory for a user (This
  106. assumes that bin already exists and the mount point for the CD-ROM is
  107. /cdrom).
  108.  
  109. To install the entire distribution on your computer, we suggest following
  110. the unzip/tar procedure mentioned above.  Alternatively, one can
  111. recursively copy all the ch_* directories, along with the binlin, libtiff,
  112. libimage and libip directories to the hard drive.  For example:
  113. cp -r /cdrom/ch_* /cdrom/binlin /cdrom/libtiff /cdrom/libimage /cdrom/libip
  114. /usr/home/<userid>/workspace
  115. would copy all the LINUX development environments to the workspace
  116. directory for a user (This assumes that workspace already exists and the
  117. mount point for the CD-ROM is /cdrom).  NOTE: LINUX may not preserve the
  118. case of the filenames copied and some builds may fail (libtiff in
  119. particular).
  120.  
  121. For convenience, a build script (build.sh) is included that will build the
  122. entire distribuition.  Type build.sh -? for instructions on how to use it.
  123.  
  124.  
  125. Examples of Program Usage
  126.  
  127. Click here to view usage examples for all the programs in this book.  An
  128. index is also provided.
  129.  
  130. Contacting the Authors
  131.  
  132. The authors may be contacted by sending mail to
  133. mlmsoftwaregroup@mindspring.com.  Alternatively the website
  134. http://www.mlmsoftwaregroup.com can be accessed for contacting the authors
  135. and code updates.
  136.  
  137.  
  138. Use and Copyright
  139.  
  140. This code is distributed under a limited-use license that may be viewed by
  141. invoking an appropriate option on the command line of each program. Unless
  142. otherwise indicated in the source code, copyright is jointly held by the
  143. authors, as indicated by a copyright notice such as: Copyright (C) 1997,
  144. 1998, 1999 MLMSoftware Group, LLC.  In some instances, we use third-party
  145. code in versions available from public sources. In those instances, the
  146. original authors, as identified in the source code, retain copyright.
  147.  
  148. Except when otherwise stated in writing, the copyright holders and/or other
  149. parties provide each program "as is" without any warranty of any kind,
  150. either expressed or implied, including, but not limited to, the implied
  151. warranties of merchantability and fitness for particular purpose. The
  152. entire risk as to the quality and performance of the programs is with the
  153. user. Should the program prove defective, the user assumes the cost of all
  154. necessary servicing, repair or correction.
  155.  
  156. In no event shall any copyright holder be liable for damages including any
  157. direct, indirect, general, special, incidental or consequential damages
  158. arising out of the use or inability to use the programs (including, but not
  159. limited to, loss of use or data, data being rendered inaccurate or losses
  160. sustained by the user or third parties or a failure of the programs to
  161. operate with any other programs) however caused, and under any theory of
  162. liability, whether in contract, strict liability, or tort.
  163.  
  164.  
  165.  
  166.  
  167. Copyright (C) 1999 MLMSoftware Group, LLC.
  168.  
  169. Red Hat is a registered trademark of Red Hat Software, Inc.
  170.  
  171. LINUX is a registered trademark of Linus Torvalds.
  172.  
  173. Photoshop is a registered trademark of Adobe Systems, Inc.
  174.  
  175. UNIX is a registered trademark of The Open Group.
  176.  
  177. Windows is a registered trademark of Microsoft Corporation.
  178.  
  179. All other trademarks and copyrights referred to are the property of their
  180. respective owners.
  181.  
  182.